home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / shpdor20.zip / SYSOP.DOC < prev   
Text File  |  1991-11-23  |  13KB  |  399 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                    SYSOP.DOC
  8.  
  9.  
  10.          Shopdoor is a bbs door program that is used for "Classified
  11.          Ads" from the bbs users. It was written using Ted Freeman's
  12.          excellent DOORFRAME door interface library. This library
  13.          allows the door to interface to most any bbs software out
  14.          there, using the bbs's own door information file. e.g.
  15.          PCBOARD.SYS, CALLINFO.BBS, DOOR.SYS  etc.  As of this
  16.          writing, the following formats are supported:
  17.  
  18.          PCBOARD.SYS (PcBoard systems using PCBOARD.SYS only)
  19.          USERS.SYS (PcBoard systems using USERS.SYS)
  20.          DOOR.SYS (Systems that support DOOR.SYS)
  21.          CALLINFO.BBS (For Wildcat systems)
  22.          DORINFOx.DEF (QBBS/RBBS/RA. Replace x with node number)
  23.          SFDOORS.DAT (Spitfire systems)
  24.          CHAIN.TXT   (WWIV Systems)
  25.          USERINFO.DAT/DOOR.SYS (Wildcat 3.x systems)
  26.  
  27.          Shopdoor is all menu driven, and easy for the user to grasp
  28.          and use. At the same time, it is very versatile, offering a
  29.          number of different ways to search and display, the ability
  30.          for a user to delete HIS OWN entries, automatically keeps
  31.          items in categories, has the ability to list items by type,
  32.          ("For Sale", "Trade", etc)., by category,
  33.          ("Cars","Software","Animals", etc), word search and many
  34.          other features. Shopdoor uses Random Access files, which
  35.          means a user can directly access an entry that is the 100th
  36.          entry, without waiting for the program to start at number 1
  37.          and go on till it reaches the entry.
  38.  
  39.          DISCLAIMER:
  40.  
  41.          This product is provided "AS IS" and the author specifically
  42.          disclaims all warranties, expressed or implied, including but
  43.          not limited to implied warranties of merchantability and
  44.          fitness for a particular purpose. In no event shall Dennis
  45.          White be liable for any loss of profit or any other
  46.          commercial damage, including but not limited to special,
  47.          incidental, consequential, or other damages.
  48.  
  49.          COPYRIGHT:
  50.  
  51.          SHOPDOOR and NEWSHOP is an original work by the author,
  52.          Dennis White, who retains the rights to the source and
  53.          object codes. SHOPDOOR and NEWSHOP is copyright 1991 by
  54.          Dennis White. The doors Development Library used to
  55.          interface the program to Bulletin Board Systems is
  56.          DOORFRAME, Copyright 1990 by Ted Freeman.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.          DISTRIBUTION:
  98.  
  99.          SHOPDOOR/NEWSHOP is distributed under the Shareware
  100.          concept. You are encouraged to distribute copies of the
  101.          ORIGINAL compressed file, as long as all original files
  102.          are included in the archive, and none of the files have
  103.          been modified in any manner.  After a reasonable
  104.          evaluation period, if you continue to use the program,
  105.          you are asked to register it. The program is FULLY
  106.          FUNCTIONAL as is, so what you will get for your $10 is
  107.          The blinking "UNREGISTERED" opening off the screen,
  108.          replaced with your BBS name and sysop name, and the
  109.          knowledge that you have done the right thing. (And any
  110.          help I can give you by calling the support bbs).
  111.  
  112.          The author maintains a bbs at (601)-234-2963 24hrs. Any
  113.          questions or problems can be addressed to SYSOP (Dennis
  114.          White) on this bbs. (The Main Board is the name of the
  115.          BBS).  Obviously, I cannot keep a copy of every type of
  116.          bbs software running just for test purposes. But
  117.          whatever type of bbs software you run, I will try and
  118.          find an answer for you. The program has been
  119.          successfully beta tested at a number of WILDCAT 3.0
  120.          boards and RA. It should work with virtually any popular
  121.          bbs software.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.          INSTALLATION:
  148.  
  149.          You must be running DOS 3.x or above.
  150.  
  151.          You should have the following files inside the archive
  152.          SHOPDOOR.ZIP:
  153.  
  154.          NEWSHOP.EXE  (The executable program) [can be renamed]
  155.          MAINHLP.HLP  (Help file for the Main Menu)
  156.          VIEWHLP.HLP  (Help file for the View Menu)
  157.          SHOP.DAT     (Data file containing a single example item)
  158.          SYSOP.DOC    (This file)
  159.          REGISTER.TXT (Registration Information)
  160.          SDCONVRT.EXE (Converts old datafile to new version)
  161.          SDCONVRT.DOC (instructions for using SDCONVERT.EXE)
  162.          SHOPDOOR.KEY (you will have this file if you registered)
  163.  
  164.  
  165.          * In addition to the above files, you should have a patched
  166.          copy of BRUN45.EXE either in the directory that runs
  167.          NEWSHOP, or in the DOS path. If you do not have this file
  168.          already, you may download it from The Main Board BBS, at
  169.          (601)-234-2963, or many other fine bbs's.
  170.  
  171.  
  172.          Make a directory and extract all the files from the
  173.          archive into this directory.
  174.  
  175.          Run the program DOCONFIG.EXE (Type DOCONFIG from the DOS
  176.          prompt). Fill in the information asked for. All the
  177.          prompts are self explanatory. When asked for the path to
  178.          your door interface file, it wants the COMPLETE filespec
  179.          to that file. (door interface file is the file your bbs
  180.          creates upon calling a door. i.e. callinfo.bbs, or
  181.          door.sys, or dorinfo1.def or whatever and where-ever
  182.          your particular bbs software creates). An example of
  183.          this path would be:
  184.  
  185.                     C:\WC30\NODE1\DOOR.SYS
  186.  
  187.          Once you have completed DOCONFIG.EXE it will create a
  188.          file called SHOPDOR.CFG in the directory it was started
  189.          from. This will be your configuration file and should
  190.          require no further modification.
  191.  
  192.          ==============Special note to multinode operation=======
  193.  
  194.          You will need to create a SHOPDOR.CFG file for each node
  195.          you operate. So, rename SHOPDOR.CFG SHOPDOR1.CFG, re run
  196.          DOCONFIG.EXE for each node, renaming each CFG file as
  197.          above. Then when you call the door, place the correct
  198.          config file on the command line from the calling batch
  199.          file. For example, if node 2 calls the program, the call
  200.          should be:  NEWSHOP SHOPDOR2.CFG.
  201.  
  202.          Also note, that although you COULD have different
  203.          catagories in different nodes, it is not particularly
  204.          recommended, since ALL items will be stored in one
  205.          datafile, and the program will ignore catagories that it
  206.          doesn't find.
  207.          =========================================================
  208.  
  209.  
  210.          NOTE: The door will run with locked DTE up to 115.2K
  211.  
  212.          Have the calling batch file change to the directory
  213.          containing the newshop files, start newshop with the
  214.          configuration file as a command line option. After leaving
  215.          the door, change back to your node home directory and restart
  216.          your bbs.  For example, the calling batch file may look like
  217.          this:
  218.  
  219.  
  220.          CD\NEWSHOP            <-- Change to proper directory
  221.          NEWSHOP SHOPDOR.CFG   <-- Start door using cfg file
  222.          CD\BBS\NODE-1         <-- Change to BBS startup directory
  223.          BBS.BAT               <-- Start up the bbs.
  224.  
  225.  
  226.  
  227.          Remember, you must have a patched copy of BRUN45.EXE
  228.          somewhere in your DOS path.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.          The door interface module supports COM 1-4 on the standard
  251.          IRQ's. That is COM1 & COM3 - IRQ4  and COM2 & COM4 - IRQ3. If
  252.          you want to use a non standard IRQ, add the IRQ number after
  253.          the configuration filename, Like this:
  254.  
  255.               NEWSHOP SHOPDOOR.CFG /5   to use IRQ5 instead of the
  256.          standard IRQ4 normally used with COM1.  If you are using the
  257.          standard IRQ's, no /x parameter is needed.
  258.  
  259.  
  260.  
  261.          This should get the door operational. If you have a problem
  262.          or for some reason it doesn't work for your setup, you may
  263.          call The Main Board BBS at 601-234-2963 and describe the
  264.          problem in as much detail as you can, and we will try to
  265.          resolve it. The bbs has a .QWK compatible mail door
  266.          to save on Long Distance $$$. It would be helpful if you
  267.          upload your SHOPDOR.CFG and calling Batch file for
  268.          examination.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.          SYSOPS: The DELETE routine will allow you to delete any item.
  275.  
  276.          Choose DELETE ITEMS from the main menu, and the program will
  277.          display a screen with the words "These are the items you have
  278.          entered....blah blah"  If the sysop has not entered any
  279.          items, there will be none listed, HOWEVER, when prompted to
  280.          enter the item number to delete, you may put ANY item number
  281.          in and it will delete it. So should the sysop want to delete
  282.          an item(s), log on, list the items however you like, make
  283.          note of the item numbers you wish to delete, and then delete
  284.          them as above.
  285.  
  286.          Only the sysop has this ability, Users are allowed to
  287.          delete only their own items, IF the sysop has configured
  288.          the program to allow users to delete.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.          SOME OPERATIONAL NOTES:
  307.  
  308.  
  309.  
  310.          When viewing the items users have entered, the screen will
  311.          list the HEADERS for the items, page at a time, and ask which
  312.          item number you wish to view. After entering the item number
  313.          to view, you will be shown expanded information on that
  314.          item.. i.e. a full page screen. Once the item has been
  315.          viewed, you will be returned to the header list, BEGINNING AT
  316.          THE NUMBER OF THE LAST ITEM VIEWED. You can enter "B" to
  317.          start the list over from the beginning. It is done this way
  318.          so that if there are several pages of items that match the
  319.          user's search criteria, the user doesn't have to start the
  320.          list over at the beginning after every item viewed.
  321.  
  322.          Only item headers that match the search criteria will be
  323.          shown. For example, if a user requests to see item in
  324.          category "CARS", only the item headers in that category will
  325.          be shown. These may be numbered something like:
  326.  
  327.          2
  328.          7
  329.          12
  330.          18
  331.          .
  332.          .
  333.          etc.
  334.  
  335.          If the user then views item number 12, after viewing, he will
  336.          be returned to the same list, but this time will only see:
  337.  
  338.          12
  339.          18
  340.          .
  341.          .
  342.          etc.
  343.  
  344.          This is the 'mark' for the last item viewed mentioned above.
  345.          To see the whole list again, the user would enter "B" at the
  346.          prompt, to see item headers 2,7,12,18...etc again.
  347.  
  348.          The program will automatically stamp the date a user enters
  349.          an item, the user's name, the type of item (FOR SALE, WANTED
  350.          etc), and if the item is not in the for sale category, it
  351.          will put "N/A" in the price field.
  352.  
  353.          ------------------------------------------------------------
  354.                           VERSION 1.2 and above ONLY
  355.  
  356.          The full screen view of an item will display a line that
  357.          reads: "Number of Times Read: <TIMES>"
  358.  
  359.          In these versions, when viewing an item full screen, the
  360.          user will be asked, "Notify <USER> you are interested in this
  361.          item (y/N)".  The default response of ENTER = No. However, if
  362.          the user viewing the item chooses Y, the program will then ask,
  363.          "Do you wish to leave <USER> a phone number where they can reach
  364.          you (y/N)?"  Again, the default response is No. If the user
  365.          answers Y, the program will prompt for a (preformatted) phone
  366.          number, including area code, and then inform the user that the
  367.          owner of the item is being notified.
  368.  
  369.          Next time the Owner of the item goes into the door, he will get
  370.          a message (immediately prior to seeing the main menu) that
  371.          <USER> is interested in thier <ITEM> and the phone number they
  372.          left is <PHONE NO>. (If they chose to leave a phone no.).
  373.          The program does this for every person who indicated interest
  374.          in any item the user has left.
  375.  
  376.  
  377.          Try the program...if you and your users like it..send $10,
  378.          download your registration key (about 50 bytes!), and
  379.          enjoy the way shareware works! You may continue using
  380.          the SHAREWARE version at no cost if you like, but you
  381.          are not subject to be notified of upgrades or changes,
  382.          and future support. The registration key will remove
  383.          the flashing UNREGISTERED words on the opening display,
  384.          and will place your name and BBS name on the opening
  385.          screen.  I hope you and your users enjoy the program!
  386.  
  387.  
  388.          Dennis White
  389.          The Main Board BBS (TMB)
  390.          601-234-2963
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.